home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / getq.z / getq
Encoding:
Text File  |  1998-10-30  |  2.9 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttqqqq((((DDDD3333))))                                                              ggggeeeettttqqqq((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_qqqq - get the next message from a queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _mmmm_bbbb_llll_kkkk______tttt _****_gggg_eeee_tttt_qqqq_((((_qqqq_uuuu_eeee_uuuu_eeee______tttt _****_q_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _q         Pointer to the queue from which the message is to be retrieved.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _gggg_eeee_tttt_qqqq gets the next available message from the top of the queue pointed to
  21.      by _q.  It handles flow control, restarting I/O that was blocked as
  22.      needed.
  23.  
  24.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  25.      If there is a message to retrieve, _gggg_eeee_tttt_qqqq returns a pointer to it.  If no
  26.      message is queued, _gggg_eeee_tttt_qqqq returns a _NNNN_UUUU_LLLL_LLLL pointer.
  27.  
  28. UUUUSSSSAAAAGGGGEEEE
  29.      _gggg_eeee_tttt_qqqq is typically used by service routines [see _ssss_rrrr_vvvv(D2)] to retrieve
  30.      queued messages.
  31.  
  32.    LLLLeeeevvvveeeellll
  33.      Base or Interrupt.
  34.  
  35.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  36.      Does not sleep.
  37.  
  38.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  39.      across calls to this function.
  40.  
  41.    EEEExxxxaaaammmmpppplllleeeessss
  42.      See _ssss_rrrr_vvvv(D2) for an example of _gggg_eeee_tttt_qqqq.
  43.  
  44. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  45.      _bbbb_cccc_aaaa_nnnn_pppp_uuuu_tttt(D3), _cccc_aaaa_nnnn_pppp_uuuu_tttt(D3), _pppp_uuuu_tttt_bbbb_qqqq(D3), _pppp_uuuu_tttt_qqqq(D3), _qqqq_eeee_nnnn_aaaa_bbbb_llll_eeee(D3), _rrrr_mmmm_vvvv_qqqq(D3),
  46.      _ssss_rrrr_vvvv(D2)
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.